home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / DEMON / HAMRADIO / KAM_MODE.ARC / !KamMode / !Manual / manual < prev    next >
Text File  |  1992-09-30  |  19KB  |  518 lines
  1. *** !KamMode ***
  2.  
  3. version 0 
  4.  
  5. Please note that at this date (22-2-92) no tests have been conducted with
  6. other than a 310.
  7.  
  8. What you need to get going.
  9.  
  10. An Archimedes, A5000 (untested) or A3000, Kantronics All Mode and suitable
  11. radio etc.
  12.  
  13.  
  14.                   MAKE A BACKUP               >>>> NOW <<<<
  15.                   
  16.              Due to a very unreasonable attitude on the part 
  17.              of my bank manager i have been unable to obtain
  18.                        an A5000 for testing !!!
  19.  
  20. -----------------------------------------------------------------------------
  21.  
  22.  
  23. Wiring the TNC to Archimedes lead. THIS may or MAY NOT APPLY TO ALL MODELS !
  24.  
  25. Archimedes                              TNC
  26. Pin 1+4+8 connected together.           (None to tnc)
  27. Pin 2                                   Pin 3
  28. Pin 3                                   Pin 2
  29. Pin 6                                   Pin 5
  30. Pin 5                                   Pins 1+7
  31. Pin 7                                   Pin 4
  32. Pin 9 (ring indicator)                  Pin 8 (connect status).
  33.  
  34. The program will run without the connection to the ring indicator but note
  35. that it is used in my packet programs.
  36.  
  37.  
  38. PLEASE Check before proceeding !
  39.  
  40. -----------------------------------------------------------------------------
  41.  
  42. Communication with the computer.
  43.  
  44. This program reads the file "baudrate" to determin the baud rate, date bits,
  45. stop bits and parity your require, edit as required.
  46.  
  47. Edit line 1 to read your required baud rate           (9600, 1200 etc.).
  48. Edit line 2 to read your required number of bits      (normally 8).
  49. Edit line 3 to read your required number of stop bits (normally 1).
  50. Edit line 4 to read your required parity              (0=none)
  51.                                                       (1=odd)
  52.                                                       (2=even)
  53.              
  54.                 ****** THIS FILE MUST NOT BE RENAMED. *****
  55.                   
  56. 9600
  57. 8
  58. 1
  59. 0
  60.  
  61. This file contains the required baud rate           (9600 1200 etc.)
  62.                                 number of bits      (normally 8)
  63.                                 parity              (0=none 1=odd 2=even)
  64.                                 number of stop bits (1 or whatever).
  65.                                 
  66. Alter ONLY the first three lines.
  67.  
  68. Note that the rx and tx rates are assumed to be the same.
  69.  
  70.                 ****** THIS FILE MUST NOT BE RENAMED. ******
  71.  
  72.  
  73. -----------------------------------------------------------------------------
  74.  
  75. TNC settings
  76.  
  77. See the file inside !YatProg called setkam for example settings for a Kam
  78. All Mode and make special note of the commands which affect CTS/RTS
  79. operation, note especially that ECHO should be OFF and DAYUSA OFF.
  80.  
  81. -----------------------------------------------------------------------------
  82.  
  83.  
  84. DESKTOP (Icon bar) MENU INSTRUCTIONS.
  85.  
  86. Info
  87.  
  88. Click on here for the usual info box.  
  89.  
  90. Quit
  91.  
  92. Click on here to remove !KamMode from the icon bar. 
  93.  
  94. To run !KamMode you MUST select a mode from the menu.
  95.  
  96. On starting !KamMode three windows open, they are 'receive', 'transmit' and
  97. a 'control' window, the 'control' window may be opened at any time by
  98. clicking in any window (except 'review') with the centre or menu button.
  99.  
  100. Review       : Opens the review window only.
  101.  
  102. TX window    : Opens the transmit window only.
  103.  
  104. RX window    : Opens the receive window only.
  105.  
  106. Control      : Opens the control/command window only.
  107.  
  108. State window : Opens the small status window only.
  109.  
  110. Auto open    : Closes all open windows and auto opens the rx window when
  111.                any text is received, 'auto open' is switched off should
  112.                anything be received.
  113. Active       : This entry toggles whether the program receives and text from
  114.                the TNC or not. This should be toggled OFF (unticked) when any
  115.                other terminal programs (!YatProg etc.) are on the icon bar to
  116.                prevent a clash of interests over the rs port.
  117.                
  118. -----------------------------------------------------------------------------
  119.  
  120. The 'control' window.
  121.         This is used like a menu but also includes save boxes for the
  122. receive buffer and direct spooling to disc. 
  123.  
  124. From left to right.
  125.         RX Buffer section. Click on the cross beside "ON/OFF" to toggle the
  126. receive buffer.
  127.      
  128.         Auto save, as above to toggle, saves buffer when full using an auto-generated filename * See later notes on saving * .
  129.  
  130.         Review, opens a review the buffer window, to update the window click
  131. on 'review' or close and re-open.
  132.  
  133.         Empty, obvious really, confirmation is required.
  134.  
  135.         Save as: Either drag the text file icon to a directory of your
  136. choice or enter a suitable filename and click on "OK".
  137.  
  138. Disc file. Clicking on the cross with 'select' opens a file using the
  139. pathname in the box below, the text file icon can be dragged to a suitable
  140. directory to grab the filename and path, do this BEFORE opening the file.
  141.  
  142. Commands. Click to send the command to the tnc.
  143.           
  144.           'TRANSMIT'   : Puts the tnc into the tx mode.       **
  145.           'RX (end)'   : Sets return to RX after text is sent.**
  146.           'RX (now)'   : Instant return to RX.                **
  147.           'Send de'    : Sends "de your call"                 **
  148.           'Send 'RY''  : Sets TX and sends a 'CQ' call.       **
  149.           'Send 'RY''  : Sets TX and sends a string of 'RY's. **
  150.           'Baud rate'  : Sets next baud rate.                 ##
  151.           'Shift'      : Sets next shift.                     ##
  152.           'Invert RX'  : Inverts RX mode.                     ##
  153.           
  154. Notes     **  Not in CW mode.
  155.           ##  RTTY and ASCII only, NOT in AMTOR, FEC or CW.
  156.           To reset a mode simply re-select it from the icon bar menu.
  157.  
  158. Upload. Any file to be transmitted can be dragged to any window, its
  159. filename appears in the bottom of the control window. To start sending click
  160. on the "GO" cross, pause and abort speak for themselves.
  161.  
  162.  
  163.              ****** THESE FILES MUST NOT BE RENAMED. ******
  164.  
  165. Send mode select/closedown sequence.
  166.  
  167. Sends the file "ASCII", "CW_RX", "LAMTOR", "RTTY", "FEC"  or "closedown" to
  168. the tnc, these files are inside !KamMode and should be edited to suit.
  169. Extra lines may be added or deleted but the files MUST exist. 
  170.  
  171. -----------------------------------------------------------------------------
  172.  
  173.              ****** THESE FILES MUST NOT BE RENAMED. ******
  174.  
  175. The file "USER" : This file MUST contain YOUR callsign.
  176.  
  177.              ****** THESE FILES MUST NOT BE RENAMED. ******
  178.              
  179. The file "CtrlCodes"
  180.  
  181. This file MUST contain the following :
  182.   
  183.   Line 1  : The command to return to packet from any other mode.
  184.   Line 2  : The command to go to transmit in a non packet mode.
  185.   Line 3  : The command to go to receive immediately in a non packet mode.
  186.   Line 4  : The command to go to receive after any text sent to the tnc has
  187.             been sent.
  188.   Line 5  : The command to change receive shift in a non packet mode.
  189.   Line 6  : The command to invert the sense of the receive in a non packet
  190.             mode.
  191.   Line 7  : The command to "listen/monitor amtor signals".
  192.   Line 8  : The command to make an amtor call to another station, on the
  193.             Kam All Mode this is "AMTOR GRQN"
  194.   Line 9  : The command to go to the FEC mode.
  195.   Line 10 : The command to go to the ASCII mode.
  196.   Line 11 : The command to go to the RTTY mode.
  197.   Line 12 : The command to go to the CW mode.
  198.  
  199.  
  200. X
  201. T
  202. R
  203. E
  204. S
  205. I
  206. LAMTOR
  207. AMTOR
  208. FEC
  209. ASCII
  210. RTTY
  211. CW
  212.  
  213.                 NOTE *** DO NOT DELETE OR ADD LINES ***            
  214.              
  215.              ****** THESE FILES MUST NOT BE RENAMED. ******
  216.              
  217. -----------------------------------------------------------------------------
  218.  
  219.  
  220. Log Window. Click here to open the log entry window.
  221.  
  222. -----------------------------------------------------------------------------
  223.  
  224. Log Entry Window. The purpose of this window is to allow the entry of
  225.                   information for the logbook.
  226.  
  227.                             **** NOTE ****
  228.  
  229. The log functions are unavailable until a !LogBook application has been
  230. 'run', attempts to open the log window prior to this will produce an error
  231. box.
  232.  
  233.                             **** NOTE ****
  234.  
  235. Use manual entry. Opens a log entry.
  236.  
  237. Do auto grab.     Looks through the last 32 received lines for the text 
  238.                   "DE " and inserts the following callsign into the
  239.                   "Log callsign" writeable icon.
  240.  
  241. Close entry.      Closes the curent log entry using the callsign in the "Log
  242.                   callsign" writeable icon.
  243.  
  244. Open.             Non active, highlited to show an entry is open.
  245.  
  246. Close down log.   Click here to make a "close down entry" in the log.
  247.  
  248. Succesfull callsign grabs result in the received text "*** CONNECTED to "
  249. being changed to "****CONNECTED to ".
  250.  
  251. All entries use the computer clock for the start time and end time and take
  252. the text in the other writeable icons to complete the log entry.
  253.  
  254. The last three entries in the file "defaults" are used as the defaults in
  255. the writeable icons DBwatts, Emission and frequency.
  256.  
  257. 11                                      "output power in DBWatts"
  258. F2D                                     "Code for emmission type"
  259. 144.65                                  "Frequency for log book"
  260. (see below)
  261.  
  262.  
  263. For the log facility to work the computer must be aware of the !LogBook
  264. application.
  265.  
  266. -----------------------------------------------------------------------------
  267.  
  268. The 'State' window : This simply reflects the state of the rx buffer, its
  269. size and whether 'auto-save' is on or off and if a receive file is open.
  270. This window is NOT 'active' so does NOT act on any mouse clicks apart from
  271. the usual close, resize etc..
  272.  
  273. -----------------------------------------------------------------------------
  274.  
  275. Clicking the menu button in the RX, TX or review windows brings up the
  276. control/command window.
  277. Clicking the select button in the tx window gains the caret.
  278. Clicking the select button in the review window updates it.
  279. Clicking the adjust button in the receive window clears it.
  280. Clicking the select button in the receive window closes all windows and sets
  281. 'auto open' ON.
  282.  
  283. IF THE TX WINDOW OWNS THE CARET THEN pressing
  284. control key + B together will toggle the buffer
  285. control key + E will empty the buffer
  286. control key + A toggles the auto-save
  287. control key + F toggles the spool to disc
  288. control key + L opens the log window.
  289. control key + S transfers as much of the receive screen to the receive
  290.                 buffer as there is room available in the receive buffer.
  291.  
  292. Note that on the spool to disc an error will be flagged if no new filename
  293. has been entered and a second or subsequent attempt is made to open a file.
  294.  
  295. Pressing function key 3 (f3) saves the buffer using an auto-generated file
  296. name and empties the buffer. For this to function the directory !Mail must
  297. be known to the machine * See later notes on saving *
  298.  
  299. Icons in the 'tx' window :
  300.   
  301.         'RECEIVE'         : Sets receive after text sent.
  302.         'TRANSMIT'        : Sets TX in RTTY, ASCII, AND FEC.
  303.         'Amtor call to'   : In AMTOR and FEC ONLY makes an amtor call to the 
  304.                             selcall in the next writeable icon.
  305.         'Abort amtor call': Aborts an amtor call.
  306.         
  307.         In the line above those icons you can enter a line containing for
  308.         example "G4RQN G4RQN DE G1XYZ G1XYZ", select this line with the mouse
  309.         and press return to send it.
  310.           
  311.  
  312.  
  313. -----------------------------------------------------------------------------
  314. The file "defaults"
  315.  
  316. (The following are examples with added comments, the actual files you use
  317. should look like the ones inside the !YatProg application.)
  318.  
  319. 11                                      "output power in DBWatts"
  320. F3E                                     "Code for emmission type"
  321. 14.08                                   "Frequency for log book"
  322.  
  323.  
  324. The file "closedown" ***** DO NOT RENAME ***** This file should consist of
  325. the commands you wish to send to your tnc and is sent by clicking on the
  326. "closedown" icon in the control window". This file can be extended at will
  327. but MUST exist.
  328.  
  329. X
  330. | Note the insertion of control C then the character X which is the command to
  331. | put the kam all mode back into the cmd: mode.
  332. CCITT OFF
  333. MARK 1600
  334. SPACE 1800
  335. SHIFT MODEM
  336. CTEXT Please wait for auto connect to the PBBS
  337. CMSG PBBS
  338. |  Next ensure that the PBBS cannot be used for 3rd party mail.
  339. PBP ON
  340. | Lines prefixed "|" will be ignored.
  341. etc
  342. etc
  343.  
  344. -----------------------------------------------------------------------------
  345.  
  346. The file "ASCII"
  347. The file "CW_rx"
  348. The file "FEC"
  349. The file "LAMTOR"
  350. The file "RTTY"
  351.  
  352. These files are all very similar and each should contain the commands necessary
  353. to set your tnc into the required mode. As with the example files shown in this
  354. document they contaon additional comments which should NOT be used in the 'real'
  355. files. They MUST be as the files inside !KamMode.
  356.  
  357. X              Command to return tnc to cmd: mode.
  358. AUTOLF OFF         Command to send to tnc, sets autolf OFF.
  359. CCITT ON           Command to send to tnc, sets CCITT tones ON.
  360. LOWTONES ON        Command to send to tnc, sets U.K. tones ON.
  361. INVERT OFF         Command to send to tnc, invert the rx signal.
  362. AUTOCR 0           Command to send to tnc, add cr to sent strings.
  363. SHIFT MODEM        Command to send to tnc, set shift tones as follows.
  364. MARK 1445          Command to send to tnc.
  365. SPACE 1275         Command to send to tnc.
  366. ASCII 300          Command to send to tnc, do ASCII ("RTTY 45" WOULD GO RTTY
  367.                    at 45 BAUD).
  368.  
  369.     
  370. "USER" This file MUST contain YOUR callsign.
  371.  
  372. -----------------------------------------------------------------------------
  373.  
  374. In the tx window there are 6 lines for the input of text to transmit, they
  375. react as follows.
  376.  
  377. At the first space after the 65th character a carriage line is inserted to
  378. allow continous typing while you look for the keys !
  379.  
  380. The caret may be moved up and down with the cursor keys and will go to the
  381. end of any line with less than 79 characters in it, on lines with 79+
  382. characters the caret will move to the start of the line, moving it to the
  383. end of full lines will cause that line to be transmitted.
  384.  
  385. All lines react in the usual way to delete, copy, control+left or right
  386. cursor keys and clear with control+U.
  387.  
  388. To send ANY character or control code then dial it up in the bottom of the
  389. tx window and click on "send control character" or with the caret in the
  390. writeable icon nearby type in the character number and press <Return> or
  391. <Enter>. NOTE THAT ONLY DECIMAL NUMBERS (NO HEX) SHOULD BE ENTERED.
  392.  
  393. -----------------------------------------------------------------------------
  394. COLOURS
  395.  
  396. The colours of the receive and review windows are user definable but as the
  397. colours used (in my humble opinion) are unlikely to be frequently changed
  398. they are defined in a file as follows.
  399.  
  400. The file is !KamMode.colours ***** DO NOT RENAME *****
  401.  
  402. Drag the file into !Edit and simply change the colour numbers as required.
  403.  
  404. Here is a copy of the file :
  405.  
  406.      8 (this is line 1)
  407.      2
  408.      1
  409.      3
  410.      8
  411.      14
  412.      1
  413.      7
  414.      1
  415.      3
  416.      7
  417.      2 (this is line 12)
  418.      | EOF | DO NOT DELETE OR ADD LINES ABOVE THIS ONE.
  419.      |
  420.      Line 1  is the colour of the receive window work foreground (text)
  421.      Line 2  is the colour of the receive window work background
  422.      Line 3  is the colour of the receive window scroll bar inner
  423.      Line 4  is the colour of the receive window scroll bar background
  424.      Line 5  is the colour of the receive window title foreground
  425.      Line 6  is the colour of the receive window title background
  426.      |    
  427.      Line 7  is the colour of the review window work foreground (text)
  428.      Line 8  is the colour of the review window work background
  429.      Line 9  is the colour of the review window scroll bar inner
  430.      Line 10 is the colour of the review window scroll bar backgroun
  431.      Line 11 is the colour of the review window title foreground
  432.      Line 12 is the colour of the review window title background
  433.      
  434.      ***** DO NOT RENAME *****
  435.  
  436. -----------------------------------------------------------------------------
  437.  
  438. * Notes on saving *
  439.  
  440. If the application !KamMode is run before the computer has seen a !Mail
  441. directory (as supplied) then the default file path entered in the file
  442. !KamMode.!Run will be used, a copy of that section is shown below.
  443. Auto-saves will be to "adfs::0.$.xxxxxxxx" where "xxxxxxxx" is the time of
  444. saving. 
  445.  
  446. In the case of !YatProg being run after a !Mail application has been 'run'
  447. auto-saves will be to the file !Mail.mail.downloads.newmail.xxxxxxxx" where
  448. "xxxxxxxx" is the time of saving.
  449.  
  450. Edit the pathname as required i.e. the section "adfs::0.$" to suit your own
  451. system.
  452.  
  453. Copy of part of !KamMode.!Run
  454. | In the line below insert a default pathname to the directory required 
  455. | (example "adfs::0.$.MailDir"), this will be used in the event of the
  456. | computer not having seen a !Mail directory.
  457. | Alter the line ONLY between the speech marks !
  458. |
  459. If <Mail$Flag>=0 Then Set Mail$Dir "adfs::0.$"
  460. |
  461.  
  462. -----------------------------------------------------------------------------
  463.  
  464.                                 Credits
  465.  
  466. Many people have unknowingly helped with this program when i have found out
  467. how to do things by looking at programs they have sent and/or written, to
  468. all of them a great big thank you !
  469.  
  470. A special thanks to G7ALN for writing 'CommLink' which showed me how to do a
  471. decent redraw !
  472.  
  473. -----------------------------------------------------------------------------
  474.  
  475.                        NOT MY FAULT DEPARTMENT
  476.  
  477. The resulting log is believed to be correct according to the rules and
  478. regulations but it is YOUR RESPONSIBILITY TO ENSURE it complies with the
  479. rules and regulations.
  480.  
  481. All this software is provided "as is"; G4RQN makes no warranty, express or
  482. implied, of the merchantability of this software or its fitness for any 
  483. particular purpose.  In no circumstances shall G4RQN be liable for any 
  484. damage, loss of profits, or any indirect or consequential loss arising  out
  485. of the use of this software or inability to use this software, even if 
  486. G4RQN has been advised of the possibility of such loss. "Software" describes
  487. the complete package and includes any circuits or connection hints included.
  488.  
  489. -----------------------------------------------------------------------------
  490.  
  491. You have received this program without charge but should you wish to make
  492. some payment then a donation to the following would be most suitable.
  493.  
  494. THE SPECIAL CARE BABY UNIT
  495. QUEEN ELIZABETH HOSPITAL
  496. GAYTON ROAD
  497. KING'S LYNN
  498. NORFOLK
  499.  
  500. Copies of the software may be passed on unmodified as long as i know where
  501. it's going, this helps me if i get queries and with updates. Should you be a
  502. brill programmer and update/upgrade the program then ok but i get the first
  503. copy.
  504.  
  505.  
  506.  
  507.                                 73s de Neil G4RQN.
  508.  
  509.                                 W. N. Rodger
  510.                                 4 Burn's Nurseries
  511.                                 Off Wootton Road
  512.                                 King's Lynn
  513.                                 Norfolk PE30 3BG
  514.  
  515.  
  516.         0553 675676 after 8pm, no reply try 0553 671118 ask for Neil.
  517.  
  518.